
<!DOCTYPE HTML>
<html lang="" >
    <head>
        <meta charset="UTF-8">
        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
        <title>logback中文网|第十二章：Groovy 配置</title>
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="description" content="logback中文网包含了logback中文文档，最新资讯，应用案例等。logback 继承自 log4j，它建立在有十年工业经验的日志系统之上。它比其它所有的日志系统更快并且更小，包含了许多独特并且有用的特性。"><meta name="keywords" content="logback中文文档, logback api文档, logback log4j,springboot logback,logback日志类型">
        <meta name="generator" content="GitBook 3.2.3">
        
        
        
    
    <link rel="stylesheet" href="gitbook/style.css">

    
            
                
                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
                
            
                
                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
                
            
                
                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
                
            
        

    

    
        
    
        
    
        
    
        
    
        
    
        
    

        
    
    
    <meta name="HandheldFriendly" content="true"/>
    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black">
    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">

    
    <link rel="next" href="13第十三章从log4j迁移.html" />
    
    
    <link rel="prev" href="11第十一章Joran.html" />
    

    </head>
    <body>
        
<div class="book">
    <div class="book-summary">
        
            
<div id="book-search-input" role="search">
    <input type="text" placeholder="Type to search" />
</div>

            
                <nav role="navigation">
                


<ul class="summary">
    
    

    

    
        
        
    
        <li class="chapter " data-level="1.1" data-path="./">
            
                <a href="./">
            
                    
                    Introduction
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2" data-path="01第一章logback介绍.html">
            
                <a href="01第一章logback介绍.html">
            
                    
                    第一章：logback 介绍
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3" data-path="02第二章架构.html">
            
                <a href="02第二章架构.html">
            
                    
                    第二章：架构
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.4" data-path="03第三章logback的配置.html">
            
                <a href="03第三章logback的配置.html">
            
                    
                    第三章：logback 的配置
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.5" data-path="04第四章Appenders.html">
            
                <a href="04第四章Appenders.html">
            
                    
                    第四章：Appenders
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6" data-path="05第五章Encoder.html">
            
                <a href="05第五章Encoder.html">
            
                    
                    第五章：Encoder
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.7" data-path="06第六章Layouts.html">
            
                <a href="06第六章Layouts.html">
            
                    
                    第六章：Layouts
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.8" data-path="07第七章Filters.html">
            
                <a href="07第七章Filters.html">
            
                    
                    第七章：Filters
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.9" data-path="08第八章MDC.html">
            
                <a href="08第八章MDC.html">
            
                    
                    第八章：MDC
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.10" data-path="09第九章日志隔离.html">
            
                <a href="09第九章日志隔离.html">
            
                    
                    第九章：日志隔离
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.11" data-path="10第十章JMX配置器.html">
            
                <a href="10第十章JMX配置器.html">
            
                    
                    第十章：JMX 配置器
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.12" data-path="11第十一章Joran.html">
            
                <a href="11第十一章Joran.html">
            
                    
                    第十一章：Joran
            
                </a>
            

            
        </li>
    
        <li class="chapter active" data-level="1.13" data-path="12第十二章Groovy配置.html">
            
                <a href="12第十二章Groovy配置.html">
            
                    
                    第十二章：Groovy 配置
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.14" data-path="13第十三章从log4j迁移.html">
            
                <a href="13第十三章从log4j迁移.html">
            
                    
                    第十三章：从 log4j 迁移
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.15" data-path="14第十四章Receivers.html">
            
                <a href="14第十四章Receivers.html">
            
                    
                    第十四章：Receivers
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.16" data-path="15第十五章使用SSL.html">
            
                <a href="15第十五章使用SSL.html">
            
                    
                    第十五章：使用 SSL
            
                </a>
            

            
        </li>
    

    

    <li class="divider"></li>

    <li>
        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
            Published with GitBook
        </a>
    </li>
</ul>


                </nav>
            
        
    </div>

    <div class="book-body">
        
            <div class="body-inner">
                
                    

<div class="book-header" role="navigation">
    

    <!-- Title -->
    <h1>
        <i class="fa fa-circle-o-notch fa-spin"></i>
        <a href="." >第十二章：Groovy 配置</a>
    </h1>
</div>




                    <div class="page-wrapper" tabindex="-1" role="main">
                        <div class="page-inner">
                            
<div id="book-search-results">
    <div class="search-noresults">
    
                                <section class="normal markdown-section">
                                
                                <p>&#x9886;&#x57DF;&#x7279;&#x5B9A;&#x8BED;&#x8A00;&#x6216;&#x8005; DSL &#x66F4;&#x52A0;&#x666E;&#x904D;&#x3002;logback &#x57FA;&#x4E8E; XML &#x7684;&#x914D;&#x7F6E;&#x53EF;&#x4EE5;&#x770B;&#x505A; DSL &#x7684;&#x5B9E;&#x4F8B;&#x3002;&#x7531;&#x4E8E; XML &#x7684;&#x672C;&#x8D28;&#xFF0C;&#x57FA;&#x4E8E; XML &#x7684;&#x914D;&#x7F6E;&#x6587;&#x4EF6;&#x53D8;&#x5F97;&#x975E;&#x5E38;&#x7684;&#x5570;&#x55E6;&#x4EE5;&#x53CA;&#x81C3;&#x80BF;&#x3002;&#x53E6;&#x5916;&#xFF0C;logback &#x4E2D;&#x7684; Joran &#x6709;&#x4E00;&#x4E2A;&#x76F8;&#x5BF9;&#x5E9E;&#x5927;&#x7684;&#x4EE3;&#x7801;&#xFF0C;&#x7528;&#x6765;&#x4E13;&#x95E8;&#x5904;&#x7406;&#x57FA;&#x4E8E; XML &#x7684;&#x914D;&#x7F6E;&#x6587;&#x4EF6;&#x3002;Joran &#x652F;&#x6301;&#x4E00;&#x4E9B;&#x975E;&#x5E38;&#x597D;&#x7684;&#x7279;&#x6027;&#xFF0C;&#x4F8B;&#x5982;&#x53D8;&#x91CF;&#x66FF;&#x6362;&#xFF0C;&#x6761;&#x4EF6;&#x5904;&#x7406;&#xFF0C;&#x4EE5;&#x53CA;&#x52A8;&#x6001;&#x6269;&#x5C55;&#x3002;&#x4F46;&#x662F;&#xFF0C;&#x4E0D;&#x4F46; Joran &#x975E;&#x5E38;&#x590D;&#x6742;&#xFF0C;&#x800C;&#x4E14;&#x7ED9;&#x7528;&#x6237;&#x7684;&#x4F53;&#x9A8C;&#x975E;&#x5E38;&#x7684;&#x4E0D;&#x597D;&#xFF0C;&#x6216;&#x8005;&#x81F3;&#x5C11;&#x4E0D;&#x76F4;&#x89C2;&#x3002;</p>
<p>&#x672C;&#x7AE0;&#x53D9;&#x8FF0;&#x57FA;&#x4E8E; Groovy &#x7684; DSL &#x81F4;&#x529B;&#x4E8E;&#x4E00;&#x81F4;&#x6027;&#xFF0C;&#x76F4;&#x89C2;&#x6027;&#xFF0C;&#x4EE5;&#x53CA;&#x975E;&#x5E38;&#x5F3A;&#x5927;&#x3002;&#x4EFB;&#x4F55;&#x4F60;&#x53EF;&#x4EE5;&#x4F7F;&#x7528; XML &#x914D;&#x7F6E;&#x7684;&#x6587;&#x4EF6;&#xFF0C;&#x4F60;&#x90FD;&#x53EF;&#x4EE5;&#x7528;&#x66F4;&#x52A0;&#x7B80;&#x77ED;&#x7684;&#x7B26;&#x53F7;&#x4F7F;&#x7528; Groovy &#x6765;&#x5B9E;&#x73B0;&#x3002;&#x4E3A;&#x4E86;&#x5E2E;&#x52A9;&#x4F60;&#x8FC1;&#x79FB;&#x5230; Groovy &#x98CE;&#x683C;&#x7684;&#x914D;&#x7F6E;&#xFF0C;&#x6211;&#x4EEC;&#x5F00;&#x53D1;&#x4E86;&#x4E00;&#x4E2A;<a href="https://logback.qos.ch/translator/asGroovy.html" target="_blank">&#x5DE5;&#x5177;</a>&#x3002;</p>
<h2 id="&#x5E38;&#x89C4;&#x5EFA;&#x8BAE;">&#x5E38;&#x89C4;&#x5EFA;&#x8BAE;</h2>
<p>&#x4E00;&#x822C;&#x6765;&#x8BF4;&#xFF0C;<em>logback.groovy</em> &#x6587;&#x4EF6;&#x662F; Groovy &#x7A0B;&#x5E8F;&#x3002;&#x56E0;&#x4E3A; Groovy &#x662F; Java &#x7684;&#x8D85;&#x96C6;&#xFF0C;&#x6240;&#x4EE5;&#x65E0;&#x8BBA;&#x4F60;&#x5728; Java &#x6267;&#x884C;&#x4EC0;&#x4E48;&#x914D;&#x7F6E;&#x64CD;&#x4F5C;&#xFF0C;&#x4F60;&#x90FD;&#x53EF;&#x4EE5;&#x5728; <em>logback.groovy</em> &#x6587;&#x4EF6;&#x4E2D;&#x505A;&#x540C;&#x6837;&#x7684;&#x4E8B;&#x60C5;&#x3002;&#x4F46;&#x662F;&#xFF0C;&#x5728; Java &#x4E2D;&#xFF0C;&#x4F7F;&#x7528;&#x53D8;&#x6210;&#x7684;&#x65B9;&#x5F0F;&#x914D;&#x7F6E; logback &#x6709;&#x70B9;&#x7B28;&#x91CD;&#xFF0C;&#x6240;&#x4EE5;&#x6211;&#x4EEC;&#x589E;&#x52A0;&#x4E86;&#x4E00;&#x4E9B; logback &#x7279;&#x6709;&#x7684;&#x6269;&#x5C55;&#x6765;&#x51CF;&#x8F7B;&#x4F60;&#x7684;&#x8D1F;&#x62C5;&#x3002;&#x6211;&#x4EEC;&#x5C1D;&#x8BD5;&#x9650;&#x5236; logback &#x7279;&#x6709;&#x7684;&#x62D3;&#x5C55;&#x7B26;&#x53F7;&#x5C3D;&#x91CF;&#x7684;&#x5C11;&#x3002;&#x5982;&#x679C;&#x4F60;&#x5DF2;&#x7ECF;&#x719F;&#x6089;&#x4E86; Groovy&#xFF0C;&#x90A3;&#x4E48;&#x4F60;&#x5E94;&#x8BE5;&#x66F4;&#x52A0;&#x5BB9;&#x6613;&#x53BB;&#x8BFB;&#xFF0C;&#x53BB;&#x7406;&#x89E3;&#x751A;&#x81F3;&#x53BB;&#x5199;&#x4F60;&#x81EA;&#x5DF1;&#x7684; <em>logback.groovy</em> &#x6587;&#x4EF6;&#x3002;&#x90A3;&#x4E48;&#x4E0D;&#x719F;&#x6089; Groovy &#x7684;&#x4EBA;&#x4F9D;&#x7136;&#x4F1A;&#x53D1;&#x73B0; <em>logback.groovy</em> &#x4E2D;&#x7684;&#x8BED;&#x6CD5;&#x6BD4; <em>logback.xml</em> &#x4E2D;&#x7684;&#x8BED;&#x6CD5;&#x66F4;&#x52A0;&#x5BB9;&#x6613;&#x4F7F;&#x7528;&#x3002;</p>
<p><em>logback.groovy</em> &#x6587;&#x4EF6;&#x662F; Groovy &#x7A0B;&#x5E8F;&#xFF0C;&#x5177;&#x6709;&#x6700;&#x5C0F;&#x7684; logback &#x7279;&#x5B9A;&#x7684;&#x62D3;&#x5C55;&#x3002;&#x6240;&#x6709;&#x5E38;&#x7528;&#x7684; groovy &#x7ED3;&#x6784;&#xFF0C;&#x4F8B;&#x5982;&#x7C7B;&#x7684;&#x5BFC;&#x5165;&#xFF0C;&#x53D8;&#x91CF;&#x5B9A;&#x4E49;&#xFF0C;&#x5B57;&#x7B26;&#x4E32; (GString) &#x4E2D;&#x5305;&#x542B; ${..} &#x8BC4;&#x4F30;&#x8868;&#x8FBE;&#x5F0F;&#xFF0C;&#x4EE5;&#x53CA; if-else &#x8BED;&#x53E5;&#x5728; <em>logback.grooby</em> &#x6587;&#x4EF6;&#x4E2D;&#x90FD;&#x662F;&#x53EF;&#x7528;&#x7684;&#x3002;</p>
<h2 id="&#x81EA;&#x52A8;&#x5BFC;&#x5165;">&#x81EA;&#x52A8;&#x5BFC;&#x5165;</h2>
<p><strong><code>1.0.10 &#x7248;&#x672C;&#x4EE5;&#x540E;</code></strong> &#x4E3A;&#x4E86;&#x51CF;&#x5C11;&#x4E0D;&#x5FC5;&#x8981;&#x7684;&#x5F15;&#x7528;&#xFF0C;&#x4E00;&#x4E9B;&#x5171;&#x540C;&#x7684;&#x7C7B;&#x4EE5;&#x53CA;&#x5305;&#x4F1A;&#x88AB;&#x81EA;&#x52A8;&#x5BFC;&#x5165;&#x3002;&#x56E0;&#x6B64;&#xFF0C;&#x53EA;&#x8981;&#x4F60;&#x53EA;&#x662F;&#x914D;&#x7F6E;&#x4E86;&#x5185;&#x7F6E;&#x7684; appender&#xFF0C;layout &#x7B49;&#x7B49;&#xFF0C;&#x4F60;&#x4E0D;&#x9700;&#x8981;&#x5728;&#x4F60;&#x7684;&#x811A;&#x672C;&#x4E2D;&#x6DFB;&#x52A0;&#x76F8;&#x5BF9;&#x5E94;&#x7684;&#x5BFC;&#x5165;&#x8BED;&#x53E5;&#x3002;&#x5F53;&#x7136;&#xFF0C;&#x5BF9;&#x4E8E;&#x9ED8;&#x8BA4;&#x5BFC;&#x5165;&#x4E0D;&#x4F1A;&#x6D89;&#x53CA;&#x5230;&#x7C7B;&#xFF0C;&#x4F60;&#x9700;&#x8981;&#x81EA;&#x5DF1;&#x5BFC;&#x5165;&#x3002;</p>
<p>&#x4E0B;&#x9762;&#x662F;&#x9ED8;&#x8BA4;&#x5BFC;&#x5165;&#x7684;&#x5217;&#x8868;&#xFF1A;</p>
<ul>
<li>import ch.qos.logback.core.*;</li>
<li>import ch.qos.logback.core.encoder.*;</li>
<li>import ch.qos.logback.core.read.*;</li>
<li>import ch.qos.logback.core.rolling.*;</li>
<li>import ch.qos.logback.core.status.*;</li>
<li>import ch.qos.logback.classic.net.*;</li>
<li>import ch.qos.logback.classic.encoder.PatternLayoutEncoder;</li>
</ul>
<p>&#x53E6;&#x5916;&#xFF0C;<code>ch.qos.logback.classic.Level</code> &#x4E2D;&#x7684;&#x6240;&#x6709;&#x5E38;&#x91CF; (&#x5927;&#x5199;) &#x90FD;&#x4F1A;&#x88AB;&#x9759;&#x6001;&#x5BFC;&#x5165;&#xFF0C;&#x4EE5;&#x53CA;&#x5C0F;&#x5199;&#x7684;&#x522B;&#x540D;&#x3002;&#x4E5F;&#x5C31;&#x662F;&#x8BF4;&#x5728;&#x4F60;&#x7684;&#x811A;&#x672C;&#x4E2D;&#x53EF;&#x4EE5;&#x5F15;&#x7528; <em>INFO</em> &#x4EE5;&#x53CA; <em>info</em>&#xFF0C;&#x800C;&#x4E0D;&#x9700;&#x8981;&#x4F7F;&#x7528;&#x9759;&#x6001;&#x5BFC;&#x5165;&#x8BED;&#x53E5;&#x3002;</p>
<h2 id="&#x4E0D;&#x518D;&#x652F;&#x6301;-siftingappender">&#x4E0D;&#x518D;&#x652F;&#x6301; SiftingAppender</h2>
<p><strong><code>1.0.12 &#x7248;&#x672C;&#x4EE5;&#x540E;</code></strong> &#x5728; groovy &#x914D;&#x7F6E;&#x6587;&#x4EF6;&#x4E2D;&#x4E0D;&#x518D;&#x652F;&#x6301; <code>SiftingAppender</code>&#x3002;&#x4F46;&#x662F;&#xFF0C;&#x5982;&#x679C;&#x6709;&#x9700;&#x8981;&#xFF0C;&#x53EF;&#x4EE5;&#x91CD;&#x65B0;&#x5F15;&#x8FDB;&#x3002;</p>
<h2 id="logbackgroovy-&#x7279;&#x5B9A;&#x7684;&#x62D3;&#x5C55;"><em>logback.groovy</em> &#x7279;&#x5B9A;&#x7684;&#x62D3;&#x5C55;</h2>
<p><strong>&#x672C;&#x8D28;&#x4E0A;&#xFF0C;<em>logback.groovy</em> &#x8BED;&#x6CD5;&#x5305;&#x542B;&#x4EE5;&#x4E0B;&#x6240;&#x8BF4;&#x7684;&#x516D;&#x4E2A;&#x65B9;&#x6CD5;&#xFF1B;&#x6309;&#x7167;&#x5B83;&#x4EEC;&#x4E60;&#x60EF;&#x4E0A;&#x76F8;&#x53CD;&#x7684;&#x987A;&#x5E8F;&#x51FA;&#x73B0;&#x3002;</strong>&#x4E25;&#x683C;&#x6765;&#x8BF4;&#xFF0C;&#x8FD9;&#x4E9B;&#x65B9;&#x6CD5;&#x7684;&#x8C03;&#x7528;&#x987A;&#x5E8F;&#x5E76;<strong>&#x4E0D;</strong>&#x91CD;&#x8981;&#xFF0C;&#x4F46;&#x662F;&#x6709;&#x4E00;&#x4E2A;&#x4F8B;&#x5916;&#xFF1A;appender &#x9644;&#x52A0;&#x5230; logger &#x4E4B;&#x524D;<strong>&#x5FC5;&#x987B;</strong>&#x88AB;&#x5B9A;&#x4E49;&#x3002;</p>
<ul>
<li><h3 id="rootlevel-level-list-appendernames--">root(Level level, List\<string\> appenderNames = [])</string\></h3>
</li>
</ul>
<p><code>root</code> &#x65B9;&#x6CD5;&#x53EF;&#x4EE5;&#x7528;&#x6765;&#x8BBE;&#x7F6E; root logger &#x7684;&#x65E5;&#x5FD7;&#x7EA7;&#x522B;&#x3002;&#x7B2C;&#x4E8C;&#x4E2A;&#x53EF;&#x9009;&#x53C2;&#x6570;&#x7684;&#x7C7B;&#x578B;&#x4E3A; <code>List&lt;String&gt;</code>&#xFF0C;&#x53EF;&#x4EE5;&#x7528;&#x6765;&#x6DFB;&#x52A0;&#x4E4B;&#x524D;&#x5B9A;&#x4E49;&#x7684; appender &#x7684;&#x540D;&#x5B57;&#x3002;&#x5982;&#x679C;&#x4F60;&#x4E0D;&#x60F3;&#x6307;&#x5B9A; appenderNames&#xFF0C;&#x90A3;&#x4E48;&#x5C31;&#x662F;&#x4E00;&#x4E2A;&#x7A7A; (empty) &#x7684;&#x5217;&#x8868;&#x3002;&#x5728; Groovy &#x4E2D;&#xFF0C;&#x7528; <code>[]</code> &#x8868;&#x793A;&#x4E00;&#x4E2A;&#x7A7A;&#x7684;&#x5217;&#x8868;&#x3002;</p>
<p>&#x8BBE;&#x7F6E; root logger &#x7684;&#x7EA7;&#x522B;&#x4E3A; WARN&#xFF0C;&#x4F60;&#x53EF;&#x4EE5;&#x8FD9;&#x6837;&#x5199;&#xFF1A;</p>
<pre><code class="lang-groovy">root(WARN)
</code></pre>
<p>&#x8BBE;&#x7F6E; root logger &#x7684;&#x7EA7;&#x522B;&#x4E3A; INFO&#xFF0C;&#x5E76;&#x4E14;&#x5C06;&#x540D;&#x4E3A; &quot;CONSOLE&quot; &#x4E0E; &quot;FILE&quot; &#x7684; appender &#x9644;&#x52A0;&#x5230; root &#x4E0A;&#xFF0C;&#x4F60;&#x53EF;&#x4EE5;&#x8FD9;&#x6837;&#x5199;&#xFF1A;</p>
<pre><code class="lang-groovy">root(INFO, [<span class="hljs-string">&quot;CONSOLE&quot;</span>, <span class="hljs-string">&quot;FILE&quot;</span>])
</code></pre>
<p>&#x5728;&#x524D;&#x9762;&#x7684;&#x4F8B;&#x5B50;&#x4E2D;&#xFF0C;&#x5047;&#x8BBE;&#x540D;&#x4E3A; &quot;CONSOLE&quot; &#x4E0E; &quot;FILE&quot; &#x7684; appender &#x5DF2;&#x7ECF;&#x88AB;&#x5B9A;&#x4E49;&#x597D;&#x4E86;&#x3002;&#x5F88;&#x5FEB;&#x5C06;&#x4F1A;&#x8BA8;&#x8BBA;&#x6709;&#x5173; appender &#x7684;&#x5B9A;&#x4E49;&#x3002;</p>
<ul>
<li><h3 id="loggerstring-name-level-level-list-appendernames---boolean-additivity--null">logger(String name, Level level, List\<string> appenderNames = [], Boolean additivity = null)</string></h3>
</li>
</ul>
<p><code>logger()</code> &#x65B9;&#x6CD5;&#x63A5;&#x6536;&#x56DB;&#x4E2A;&#x53C2;&#x6570;&#xFF0C;&#x6700;&#x540E;&#x4E24;&#x4E2A;&#x662F;&#x53EF;&#x9009;&#x7684;&#x3002;&#x7B2C;&#x4E00;&#x4E2A;&#x53C2;&#x6570;&#x8868;&#x793A;&#x914D;&#x7F6E; logger &#x7684;&#x540D;&#x5B57;&#x3002;&#x7B2C;&#x4E8C;&#x53C2;&#x6570;&#x8868;&#x793A;&#x6307;&#x5B9A; logger &#x7684;&#x7EA7;&#x522B;&#x3002;&#x8BBE;&#x7F6E; logger &#x7684;&#x7EA7;&#x522B;&#x4E3A; <code>null</code> &#x5C06;&#x5F3A;&#x5236;&#x5B83;&#x4ECE;&#x5B83;&#x6700;&#x8FD1;&#x7684;&#x7956;&#x5148;&#x90A3;&#x91CC;<a href="https://github.com/Volong/logback-chinese-manual/blob/master/02%E7%AC%AC%E4%BA%8C%E7%AB%A0%EF%BC%9A%E6%9E%B6%E6%9E%84.md#%E6%9C%89%E6%95%88%E7%AD%89%E7%BA%A7%E5%8F%88%E7%A7%B0%E4%B8%BA%E7%AD%89%E7%BA%A7%E7%BB%A7%E6%89%BF" target="_blank">&#x7EE7;&#x627F;</a>&#x7EA7;&#x522B;&#x3002;&#x7B2C;&#x4E09;&#x4E2A;&#x53C2;&#x6570;&#x7684;&#x7C7B;&#x578B;&#x4E3A; <code>List&lt;String&gt;</code>&#xFF0C;&#x662F;&#x53EF;&#x9009;&#x7684;&#xFF0C;&#x9ED8;&#x8BA4;&#x4E3A;&#x7A7A;&#x5217;&#x8868;&#x3002;&#x5217;&#x8868;&#x4E2D; appender &#x4F1A;&#x88AB;&#x9644;&#x52A0;&#x5230;&#x6307;&#x5B9A;&#x7684; logger &#x4E0A;&#x53BB;&#x3002;&#x7B2C;&#x56DB;&#x4E2A;&#x53C2;&#x6570;&#x7684;&#x7C7B;&#x578B;&#x4E3A; <code>Boolean</code>&#xFF0C;&#x4E5F;&#x662F;&#x53EF;&#x9009;&#x7684;&#xFF0C;&#x7528;&#x6765;&#x63A7;&#x5236;<a href="https://github.com/Volong/logback-chinese-manual/blob/master/02%E7%AC%AC%E4%BA%8C%E7%AB%A0%EF%BC%9A%E6%9E%B6%E6%9E%84.md#appender-%E4%B8%8E-layout" target="_blank">&#x53E0;&#x52A0;&#x6027;</a>&#x3002;&#x5982;&#x679C;&#x5FFD;&#x7565;&#xFF0C;&#x9ED8;&#x8BA4;&#x503C;&#x4E3A; <code>null</code>&#x3002;</p>
<p>&#x4F8B;&#x5982;&#xFF0C;&#x4E0B;&#x9762;&#x8FD9;&#x4E2A;&#x811A;&#x672C;&#x8BBE;&#x7F6E; &quot;com.foo&quot; &#x8FD9;&#x4E2A; logger &#x7684;&#x7EA7;&#x522B;&#x4E3A; INFO&#xFF1A;</p>
<pre><code class="lang-groovy">logger(<span class="hljs-string">&quot;com.foo&quot;</span>, INFO)
</code></pre>
<p>&#x4E0B;&#x4E2A;&#x811A;&#x672C;&#x8BBE;&#x7F6E; &quot;com.foo&quot; &#x8FD9;&#x4E2A; logger &#x7684;&#x7EA7;&#x522B;&#x4E3A; DEBUG&#xFF0C;&#x5E76;&#x4E14;&#x5C06;&#x540D;&#x4E3A; &quot;CONSOLE&quot; &#x7684; appender &#x9644;&#x52A0;&#x5230;&#x5176;&#x4E0A;&#xFF1A;</p>
<pre><code class="lang-groovy">logger(<span class="hljs-string">&quot;com.foo&quot;</span>, DEBUG, [<span class="hljs-string">&quot;CONSOLE&quot;</span>])
</code></pre>
<p>&#x4E0B;&#x4E2A;&#x811A;&#x672C;&#x8DDF;&#x4E0A;&#x4E00;&#x4E2A;&#x7C7B;&#x4F3C;&#xFF0C;&#x53EA;&#x662F;&#x8FD9;&#x4E2A;&#x8FD8;&#x8BBE;&#x7F6E;&#x4E86; &quot;com.foo&quot; &#x8FD9;&#x4E2A; logger &#x7684;&#x53E0;&#x52A0;&#x6027;&#x4E3A; false&#xFF1A;</p>
<pre><code class="lang-groovy">logger(<span class="hljs-string">&quot;com.foo&quot;</span>, DEBUG, [<span class="hljs-string">&quot;CONSOLE&quot;</span>]&#xFF0C;<span class="hljs-literal">false</span>)
</code></pre>
<ul>
<li><h3 id="appenderstring-name-class-clazz-closure-closure--null">appender(String name, Class clazz, Closure closure = null)</h3>
</li>
</ul>
<p>appender &#x65B9;&#x6CD5;&#x7684;&#x7B2C;&#x4E00;&#x4E2A;&#x53C2;&#x6570;&#x63A5;&#x6536; appender &#x7684;&#x540D;&#x5B57;&#x8FDB;&#x884C;&#x914D;&#x7F6E;&#x3002;&#x7B2C;&#x4E8C;&#x4E2A;&#x53C2;&#x6570;&#x662F;&#x5F3A;&#x5236;&#x7684;&#xFF0C;&#x8868;&#x793A; appender &#x5B9E;&#x4F8B;&#x5316;&#x7684;&#x7C7B;&#x3002;&#x7B2C;&#x4E09;&#x4E2A;&#x53C2;&#x6570;&#x5305;&#x542B;&#x66F4;&#x591A;&#x7684;&#x914D;&#x7F6E;&#x4FE1;&#x606F;&#x3002;&#x5982;&#x679C;&#x5FFD;&#x7565;&#xFF0C;&#x9ED8;&#x8BA4;&#x4E3A; null&#x3002;</p>
<p>&#x5927;&#x90E8;&#x5206; appender &#x90FD;&#x9700;&#x8981;&#x8BBE;&#x7F6E;&#x5C5E;&#x6027;&#xFF0C;&#x5E76;&#x4E14;&#x6CE8;&#x5165;&#x5B50;&#x7EC4;&#x4EF6;&#x624D;&#x80FD;&#x6B63;&#x5E38;&#x5DE5;&#x4F5C;&#x3002;&#x5C5E;&#x6027;&#x901A;&#x8FC7; &apos;=&apos; &#x8FDB;&#x884C;&#x8BBE;&#x7F6E;&#x3002;&#x5B50;&#x7EC4;&#x4EF6;&#x7684;&#x6CE8;&#x5165;&#x901A;&#x8FC7;&#x8C03;&#x7528;&#x4EE5;&#x5C5E;&#x6027;&#x547D;&#x540D;&#x7684;&#x65B9;&#x6CD5;&#xFF0C;&#x5E76;&#x4E14;&#x5C06;&#x5B9E;&#x4F8B;&#x5316;&#x7684;&#x7C7B;&#x4F5C;&#x4E3A;&#x53C2;&#x6570;&#x4F20;&#x9012;&#x7ED9;&#x8BE5;&#x65B9;&#x6CD5;&#x3002;&#x8FD9;&#x4E2A;&#x7EA6;&#x5B9A;&#x53EF;&#x4EE5;&#x88AB;&#x9012;&#x5F52;&#x7684;&#x5E94;&#x7528;&#x5230;&#x914D;&#x7F6E;&#x7684;&#x5C5E;&#x6027;&#x4EE5;&#x53CA;&#x4EFB;&#x4F55; appender &#x5B50;&#x7EC4;&#x4EF6;&#x7684;&#x5B50;&#x7EC4;&#x4EF6;&#x4E2D;&#x3002;&#x8FD9;&#x4E2A;&#x65B9;&#x6CD5;&#x662F; <em>logback.groovy</em> &#x7684;&#x6838;&#x5FC3;&#xFF0C;&#x53EF;&#x80FD;&#x662F;&#x552F;&#x4E00;&#x9700;&#x8981;&#x53BB;&#x5B66;&#x4E60;&#x7684;&#x7EA6;&#x5B9A;&#x3002;</p>
<p>&#x4F8B;&#x5982;&#xFF0C;&#x63A5;&#x4E0B;&#x6765;&#x7684;&#x811A;&#x672C;&#x5B9E;&#x4F8B;&#x5316;&#x4E00;&#x4E2A; <code>FileAppender</code> &#x547D;&#x540D;&#x4E3A; &quot;FILE&quot;&#xFF0C;&#x8BBE;&#x7F6E;&#x5B83;&#x7684; <code>file</code> &#x5C5E;&#x6027;&#x4E3A; &quot;testFile.log&quot;&#xFF0C;&#x4EE5;&#x53CA;&#x5B83;&#x7684; <code>append</code> &#x5C5E;&#x6027;&#x8BBE;&#x7F6E;&#x4E3A; false&#x3002;&#x7C7B;&#x578B;&#x4E3A; <code>PatternLayoutEncoder</code> &#x7684; encoder &#x88AB;&#x6CE8;&#x5165;&#x5230;&#x8FD9;&#x4E2A; appender &#x4E2D;&#x3002;encoder &#x7684;&#x6A21;&#x5F0F;&#x5C5E;&#x6027;&#x8BBE;&#x7F6E;&#x4E3A; &quot;%level %logger - %msg%n&quot;&#x3002;&#x7136;&#x540E;&#x5C06;&#x8FD9;&#x4E2A; appender &#x9644;&#x52A0;&#x5230; root logger &#x4E0A;&#x3002;</p>
<pre><code class="lang-groovy">appender(<span class="hljs-string">&quot;FILE&quot;</span>, FileAppender) {
    file = <span class="hljs-string">&quot;testFile.log&quot;</span>
    append = <span class="hljs-literal">false</span>
    encoder(PatternLayoutEncoder) {
        pattern = <span class="hljs-string">&quot;%level %logger - %msg%n&quot;</span>
    }
}

root(DEBUG, [<span class="hljs-string">&quot;FILE&quot;</span>])
</code></pre>
<ul>
<li><h3 id="timestampstring-datepattern-long-timereference---1">timestamp(String datePattern, long timeReference = -1)</h3>
</li>
</ul>
<p><code>timestamp()</code> &#x65B9;&#x6CD5;&#x6839;&#x636E; <code>datePattern</code> &#x5C06; <code>timeReference</code> &#x53C2;&#x6570;&#x683C;&#x5F0F;&#x5316;&#xFF0C;&#x8FD4;&#x56DE;&#x4E00;&#x4E2A;&#x5BF9;&#x5E94;&#x7684;&#x5B57;&#x7B26;&#x4E32;&#x3002;<code>datePattern</code> &#x53C2;&#x6570;&#x5E94;&#x8BE5;&#x5C0A;&#x6751; <a href="https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html" target="_blank">SimpleDateFormat</a> &#x4E2D;&#x5B9A;&#x4E49;&#x7684;&#x7EA6;&#x5B9A;&#x3002;&#x5982;&#x679C; <code>timeReference</code> &#x6CA1;&#x6709;&#x6307;&#x5B9A;&#xFF0C;&#x90A3;&#x4E48;&#x9ED8;&#x8BA4;&#x4E3A; -1&#x3002;&#x5728;&#x8FD9;&#x79CD;&#x60C5;&#x51B5;&#x4E0B;&#xFF0C;&#x5F53;&#x89E3;&#x6790;&#x914D;&#x7F6E;&#x6587;&#x4EF6;&#x65F6;&#xFF0C;&#x5F53;&#x524D;&#x65F6;&#x95F4;&#x4F5C;&#x4E3A; <code>timeReference</code> &#x53C2;&#x6570;&#x7684;&#x503C;&#x3002;</p>
<p>&#x5728;&#x4E0B;&#x4E2A;&#x4F8B;&#x5B50;&#x4E2D;&#xFF0C;<code>bySecond</code> &#x53D8;&#x91CF;&#x8868;&#x793A;&#x88AB; &quot;yyyyMMdd&apos;T&apos;HHmmss&quot; &#x683C;&#x5F0F;&#x5316;&#x4E4B;&#x540E;&#x7684;&#x5F53;&#x524D;&#x65F6;&#x95F4;&#x3002;&#x4E4B;&#x540E;&#xFF0C;&quot;bySecond&quot; &#x53D8;&#x91CF;&#x88AB;&#x7528;&#x4E8E; <code>file</code> &#x5C5E;&#x6027;&#x7684;&#x5B9A;&#x4E49;&#x4E2D;&#x3002;</p>
<pre><code class="lang-groovy"><span class="hljs-keyword">def</span> bySecond = timestamp(<span class="hljs-string">&quot;yyyyMMdd&apos;T&apos;HHmmss&quot;</span>)

appender(<span class="hljs-string">&quot;FILE&quot;</span>, FileAppender) {
    file = <span class="hljs-string">&quot;log-${bySecond}.txt&quot;</span>
    encoder(PatternLayoutEncoder) {
        pattern = <span class="hljs-string">&quot;%logger{35} - %msg%n&quot;</span>
    }
}

root(DEBUG, [<span class="hljs-string">&quot;FILE&quot;</span>])
</code></pre>
<ul>
<li><h3 id="conversionrulestring-conversionword-class-converterclass">conversionRule(String conversionWord, Class converterClass)</h3>
</li>
</ul>
<p>&#x5728;&#x521B;&#x5EFA;&#x4E86;&#x4F60;&#x81EA;&#x5DF1;&#x7684;<a href="https://github.com/Volong/logback-chinese-manual/blob/master/06%E7%AC%AC%E5%85%AD%E7%AB%A0%EF%BC%9ALayouts.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E8%BD%AC%E6%8D%A2%E8%AF%B4%E6%98%8E%E7%AC%A6" target="_blank">&#x8F6C;&#x6362;&#x8BF4;&#x660E;&#x7B26;</a>&#x4E4B;&#x540E;&#xFF0C;&#x4F60;&#x9700;&#x8981;&#x901A;&#x77E5; logback &#x5B83;&#x7684;&#x5B58;&#x5728;&#x3002;&#x4E0B;&#x9762;&#x8FD9;&#x4E2A;&#x7B80;&#x5355;&#x7684; logback.groovy &#x6587;&#x4EF6;&#x544A;&#x8BC9; logback &#x5728;&#x9047;&#x5230; <code>%sample</code> &#x8F6C;&#x6362;&#x5B57;&#x7B26;&#x65F6;&#x4F7F;&#x7528; MySampleConverter&#x3002;</p>
<pre><code class="lang-groovy"><span class="hljs-keyword">import</span> chapters.layouts.MySampleConverter

conversionRule(<span class="hljs-string">&quot;sample&quot;</span>, MySampleConverter)
appender(<span class="hljs-string">&quot;STDOUT&quot;</span>, ConsoleAppender) {
    encoder(PatternLayoutEncoder) {
        pattern = <span class="hljs-string">&quot;%-4relative [%thread] %sample - %msg%n&quot;</span>
    }
}

root(DEBUG, [<span class="hljs-string">&quot;STDOUT&quot;</span>])
</code></pre>
<ul>
<li><h3 id="scanstring-scanperiod--null">scan(String scanPeriod = null)</h3>
</li>
</ul>
<p>&#x8C03;&#x7528; scan() &#x65B9;&#x6CD5;&#x544A;&#x8BC9; logback &#x5468;&#x671F;&#x6027;&#x7684;&#x626B;&#x63CF; logback.groovy &#x6587;&#x4EF6;&#x7684;&#x53D8;&#x5316;&#x3002;&#x5F53;&#x68C0;&#x6D4B;&#x5230;&#x53D8;&#x5316;&#x65F6;&#xFF0C;<em>logback.groovy</em> &#x6587;&#x4EF6;&#x4F1A;&#x88AB;&#x91CD;&#x65B0;&#x52A0;&#x8F7D;&#x3002;</p>
<pre><code class="lang-groovy">scan()
</code></pre>
<p>&#x9ED8;&#x8BA4;&#x60C5;&#x51B5;&#x4E0B;&#xFF0C;&#x4E00;&#x5206;&#x949F;&#x626B;&#x63CF;&#x4E00;&#x6B21;&#x914D;&#x7F6E;&#x6587;&#x4EF6;&#x3002;&#x4F60;&#x53EF;&#x4EE5;&#x901A;&#x8FC7; &quot;scanPeriod&quot; &#x6765;&#x6307;&#x5B9A;&#x4E00;&#x4E2A;&#x4E0D;&#x540C;&#x7684;&#x626B;&#x63CF;&#x5468;&#x671F;&#x3002;&#x5B83;&#x7684;&#x503C;&#x53EF;&#x4EE5;&#x88AB;&#x6307;&#x5B9A;&#x4EE5; milliseconds, seconds, minutes &#x6216;&#x8005; hours &#x4F4D;&#x5355;&#x4F4D;&#x3002;&#x4F8B;&#x5982;&#xFF1A;</p>
<pre><code class="lang-groovy">scan(<span class="hljs-string">&quot;30 seconds&quot;</span>)
</code></pre>
<p>&#x5982;&#x679C;&#x6CA1;&#x6709;&#x6307;&#x5B9A;&#x65F6;&#x95F4;&#x5355;&#x4F4D;&#xFF0C;&#x90A3;&#x4E48;&#x9ED8;&#x8BA4;&#x7684;&#x65F6;&#x95F4;&#x5355;&#x4F4D;&#x4E3A; milliseconds&#xFF0C;&#x4F46;&#x662F;&#x901A;&#x5E38;&#x6765;&#x8BF4;&#x662F;&#x4E0D;&#x5408;&#x9002;&#x7684; (&#x65E2;&#x7136;&#x4E0D;&#x5408;&#x9002;&#xFF0C;&#x4E3A;&#x4EC0;&#x4E48;&#x9ED8;&#x8BA4;&#x8FD8;&#x662F;&#x6BEB;&#x79D2;&#xFF0C;&#x8D39;&#x89E3;&#x1F914;)&#x3002;&#x5982;&#x679C;&#x4F60;&#x66F4;&#x6539;&#x4E86;&#x9ED8;&#x8BA4;&#x7684;&#x626B;&#x63CF;&#x5468;&#x671F;&#xFF0C;&#x8BB0;&#x5F97;&#x8981;&#x6307;&#x5B9A;&#x65F6;&#x95F4;&#x5355;&#x4F4D;&#x3002;&#x66F4;&#x591A;&#x5173;&#x4E8E;&#x626B;&#x63CF;&#x5DE5;&#x4F5C;&#x7684;&#x7EC6;&#x8282;&#xFF0C;&#x8BF7;&#x67E5;&#x770B;<a href="https://github.com/Volong/logback-chinese-manual/blob/master/03%E7%AC%AC%E4%B8%89%E7%AB%A0%EF%BC%9Alogback%20%E7%9A%84%E9%85%8D%E7%BD%AE.md#%E5%BD%93%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E6%9B%B4%E6%94%B9%E6%97%B6%E8%87%AA%E5%8A%A8%E5%8A%A0%E8%BD%BD" target="_blank">&#x81EA;&#x52A8;&#x52A0;&#x8F7D;</a>&#x90E8;&#x5206;&#x3002;</p>
<ul>
<li><h3 id="statuslistenerclass-listenerclass">statusListener(Class listenerClass)</h3>
</li>
</ul>
<p>&#x4F60;&#x53EF;&#x4EE5;&#x901A;&#x8FC7;&#x8C03;&#x7528; <code>statusListener</code> &#x65B9;&#x6CD5;&#xFF0C;&#x5E76;&#x7ED9;&#x8BE5;&#x65B9;&#x6CD5;&#x4F20;&#x9012;&#x4E00;&#x4E2A;&#x76D1;&#x542C;&#x5668;&#x7C7B;&#xFF0C;&#x6765;&#x6DFB;&#x52A0;&#x4E00;&#x4E2A;&#x72B6;&#x6001;&#x76D1;&#x542C;&#x5668;&#x3002;&#x4F8B;&#xFF1A;</p>
<pre><code class="lang-groovy"><span class="hljs-keyword">import</span> chapters.layouts.MySampleConverter

<span class="hljs-comment">// &#x5F3A;&#x70C8;&#x5EFA;&#x8BAE;&#x5728;&#x6700;&#x540E;&#x4E00;&#x4E2A;&#x5BFC;&#x5165;&#x8BED;&#x53E5;&#x4E4B;&#x540E;&#xFF0C;&#x5176;&#x5B83;&#x6240;&#x6709;&#x8BED;&#x53E5;&#x4E4B;&#x524D;&#x6DFB;&#x52A0;&#x72B6;&#x6001;&#x76D1;&#x542C;&#x5668;</span>
statusListener(OnConsoleStatusListener)
</code></pre>
<p>&#x5173;&#x4E8E;<a href="https://github.com/Volong/logback-chinese-manual/blob/master/03%E7%AC%AC%E4%B8%89%E7%AB%A0%EF%BC%9Alogback%20%E7%9A%84%E9%85%8D%E7%BD%AE.md#%E7%9B%91%E5%90%AC%E7%8A%B6%E6%80%81%E4%BF%A1%E6%81%AF" target="_blank">&#x72B6;&#x6001;&#x76D1;&#x542C;&#x5668;</a>&#x8BF7;&#x67E5;&#x770B;&#x4E4B;&#x524D;&#x7684;&#x7AE0;&#x8282;&#x3002;</p>
<ul>
<li><h3 id="jmxconfiguratorstring-name">jmxConfigurator(String name)</h3>
</li>
</ul>
<p>&#x4F60;&#x53EF;&#x4EE5;&#x901A;&#x8FC7;&#x8BE5;&#x65B9;&#x6CD5;&#x6CE8;&#x518C;&#x4E00;&#x4E2A; <a href="https://logback.qos.ch/manual/jmxConfig.html" target="_blank"><code>JMXConfigurator</code></a> MBean&#x3002;&#x65E0;&#x53C2;&#x8C03;&#x7528;&#x5C06;&#x4F1A;&#x4F7F;&#x7528; logback &#x9ED8;&#x8BA4;&#x7684;&#x5BF9;&#x8C61;&#x540D; (<code>ch.qos.logback.classic:Name=default,Type=ch.qos.logback.classic.jmx.JMXConfigurator</code>) &#x53BB;&#x6CE8;&#x518C; MBean&#x3002;</p>
<pre><code class="lang-groovy">jmxConfigurator()
</code></pre>
<p>&#x8981;&#x6539;&#x53D8; <code>Name</code> &#x952E;&#x7684;&#x503C;&#xFF0C;&#x800C;&#x4E0D;&#x662F; &quot;default&quot;&#xFF0C;&#x4EC5;&#x4EC5;&#x53EA;&#x9700;&#x8981;&#x7ED9; <code>jmxConfigurator</code> &#x65B9;&#x6CD5;&#x4F20;&#x9012;&#x4E00;&#x4E2A;&#x4E0D;&#x540C;&#x7684;&#x540D;&#x5B57;&#x53C2;&#x6570;&#x5C31;&#x53EF;&#x4EE5;&#x4E86;&#x3002;</p>
<pre><code class="lang-groovy">jmxConfigurator(<span class="hljs-string">&apos;MyName&apos;</span>)
</code></pre>
<p>&#x5982;&#x679C;&#x4F60;&#x60F3;&#x8981;&#x5B8C;&#x6574;&#x7684;&#x5B9A;&#x4E49;&#x5BF9;&#x8C61;&#x540D;&#xFF0C;&#x53EF;&#x4EE5;&#x4F7F;&#x7528;&#x540C;&#x6837;&#x7684;&#x8BED;&#x6CD5;&#xFF0C;&#x4F46;&#x662F;&#x9700;&#x8981;&#x4F20;&#x9012;&#x4E00;&#x4E2A;&#x6709;&#x6548;&#x7684;&#x5BF9;&#x8C61;&#x540D;&#x5B57;&#x7B26;&#x4E32;&#x4F5C;&#x4E3A;&#x53C2;&#x6570;&#xFF1A;</p>
<pre><code class="lang-groovy">jmxConfigurator(<span class="hljs-string">&apos;myApp:type=LoggerManager&apos;</span>)
</code></pre>
<p>&#x8BE5;&#x65B9;&#x6CD5;&#x9996;&#x5148;&#x4F1A;&#x53BB;&#x5C1D;&#x8BD5;&#x5C06;&#x8BE5;&#x53C2;&#x6570;&#x4F5C;&#x4E3A;&#x5BF9;&#x8C61;&#x540D;&#xFF0C;&#x5982;&#x679C;&#x5B83;&#x4E0D;&#x8868;&#x793A;&#x4E00;&#x4E2A;&#x6709;&#x6548;&#x7684;&#x5BF9;&#x8C61;&#x540D;&#xFF0C;&#x5219;&#x4F1A;&#x628A;&#x5B83;&#x5F53;&#x4F5C; &quot;Name&quot; &#x952E;&#x7684;&#x503C;&#x3002;</p>
<h2 id="&#x5185;&#x7F6E;-dsl">&#x5185;&#x7F6E; DSL</h2>
<p><em>logback.groovy</em> &#x662F;&#x4E00;&#x4E2A;&#x5185;&#x7F6E; DSL &#x7684;&#x610F;&#x601D;&#x662F;&#xFF0C;&#x5B83;&#x7684;&#x5185;&#x5BB9;&#x53EF;&#x4EE5;&#x4F5C;&#x4E3A; Groovy &#x811A;&#x672C;&#x6267;&#x884C;&#x3002;&#x56E0;&#x6B64;&#xFF0C;&#x6240;&#x6709;&#x5E38;&#x7528;&#x7684; Groovy &#x6307;&#x4EE4;&#xFF0C;&#x4F8B;&#x5982;&#x7C7B;&#x7684;&#x5BFC;&#x5165;&#xFF0C;GString&#xFF0C;&#x53D8;&#x91CF;&#x7684;&#x5B9A;&#x4E49;&#xFF0C;&#x5305;&#x542B;&#x5B57;&#x7B26;&#x4E32; (GString) &#x7684; ${..} &#x8BC4;&#x4F30;&#x8868;&#x8FBE;&#x5F0F;&#xFF0C;if-else &#x8BED;&#x53E5;&#x8FD9;&#x4E9B;&#x5728; logback.groovy &#x6587;&#x4EF6;&#x4E2D;&#x90FD;&#x662F;&#x53EF;&#x7528;&#x7684;&#x3002;&#x5728;&#x63A5;&#x4E0B;&#x6765;&#x7684;&#x8BA8;&#x8BBA;&#x4E2D;&#xFF0C;&#x6211;&#x4EEC;&#x5C06;&#x4F1A;&#x5C55;&#x793A; Groovy &#x6307;&#x4EE4;&#x5728; <em>logback.groovy</em> &#x6587;&#x4EF6;&#x4E2D;&#x7684;&#x5178;&#x578B;&#x7528;&#x6CD5;&#x3002;</p>
<h3 id="&#x53D8;&#x91CF;&#x5B9A;&#x4E49;&#x4E0E;-gstring">&#x53D8;&#x91CF;&#x5B9A;&#x4E49;&#x4E0E; GString</h3>
<p>&#x4F60;&#x53EF;&#x4EE5;&#x5728; <em>logback.groovy</em> &#x6587;&#x4EF6;&#x4E2D;&#x7684;&#x4EFB;&#x4F55;&#x5730;&#x65B9;&#x5B9A;&#x4E49;&#x53D8;&#x91CF;&#xFF0C;&#x7136;&#x540E;&#x5728; GString &#x4E2D;&#x4F7F;&#x7528;&#x8BE5;&#x53D8;&#x91CF;&#x3002;&#x4F8B;&#x5982;&#xFF1A;</p>
<pre><code class="lang-groovy"><span class="hljs-keyword">def</span> USER_HOME = System.getProperty(<span class="hljs-string">&quot;user.home&quot;</span>)

appender(<span class="hljs-string">&quot;FILE&quot;</span>, FileAppender) {
    <span class="hljs-comment">// &#x4F7F;&#x7528; USER_HOME &#x53D8;&#x91CF;</span>
    file = <span class="hljs-string">&quot;${USER_HOME}/myApp.log&quot;</span>
    encoder(PatternLayoutEncoder) {
        pattern = <span class="hljs-string">&quot;%msg%n&quot;</span>
    }
}
root(DEBUG, [<span class="hljs-string">&quot;FILE&quot;</span>])
</code></pre>
<h3 id="&#x5728;&#x63A7;&#x5236;&#x53F0;&#x6253;&#x5370;">&#x5728;&#x63A7;&#x5236;&#x53F0;&#x6253;&#x5370;</h3>
<p>&#x901A;&#x8FC7;&#x8C03;&#x7528; Groovy &#x7684; <code>println</code> &#x65B9;&#x6CD5;&#x5728;&#x63A7;&#x5236;&#x53F0;&#x8FDB;&#x884C;&#x6253;&#x5370;&#x3002;&#x4F8B;&#x5982;&#xFF1A;</p>
<pre><code class="lang-groovy"><span class="hljs-keyword">def</span> USER_HOME = System.getProperty(<span class="hljs-string">&quot;user.home&quot;</span>);
println <span class="hljs-string">&quot;USER_HOME=${USER_HOME}&quot;</span>

appender(<span class="hljs-string">&quot;FILE&quot;</span>, FileAppender) {
    println <span class="hljs-string">&quot;Setting [file] property to [${USER_HOME}/myApp.log]&quot;</span>
    file = <span class="hljs-string">&quot;${USER_HOME}/myApp.log&quot;</span>
    encoder(PatternLayoutEncoder) {
        pattern = <span class="hljs-string">&quot;%msg%n&quot;</span>
    }
}
root(DEBUG, [<span class="hljs-string">&quot;FILE&quot;</span>])
</code></pre>
<h3 id="&#x81EA;&#x52A8;&#x8F93;&#x51FA;&#x5B57;&#x6BB5;">&#x81EA;&#x52A8;&#x8F93;&#x51FA;&#x5B57;&#x6BB5;</h3>
<h4 id="hostname-&#x53D8;&#x91CF;">&apos;hostname&apos; &#x53D8;&#x91CF;</h4>
<p>&apos;hostname&apos; &#x53D8;&#x91CF;&#x5305;&#x542B;&#x5F53;&#x524D; host &#x7684;&#x540D;&#x5B57;&#x3002;&#x4F46;&#x662F;&#x7531;&#x4E8E;&#x4F5C;&#x7528;&#x57DF;&#x89C4;&#x5219;&#xFF0C;&#x6240;&#x4EE5;&#x4F5C;&#x8005;&#x4E0D;&#x80FD;&#x5B8C;&#x5168;&#x89E3;&#x91CA;&#x6E05;&#x695A; (&#x1F613;)&#x3002;&apos;hostname&apos; &#x53D8;&#x91CF;&#x53EA;&#x5728;&#x6700;&#x4E0A;&#x5C42;&#x7684;&#x4F5C;&#x7528;&#x57DF;&#x4E2D;&#x6709;&#x6548;&#xFF0C;&#x4F46;&#x662F;&#x5728;&#x5185;&#x90E8;&#x7684;&#x4F5C;&#x7528;&#x57DF;&#x4E2D;&#x65E0;&#x6548;&#x3002;&#x4E0B;&#x9762;&#x7684;&#x4F8B;&#x5B50;&#x5E94;&#x8BE5;&#x53EF;&#x4EE5;&#x89E3;&#x91CA;&#x8FD9;&#x4E00;&#x70B9;&#xFF1A;</p>
<pre><code class="lang-groovy"><span class="hljs-comment">// &#x5982;&#x679C;&#x5F53;&#x524D; host &#x7684;&#x540D;&#x5B57;&#x4E3A; x&#xFF0C;&#x90A3;&#x4E48;&#x5C06;&#x4F1A;&#x8F93;&#x51FA; &quot;hostname is x&quot;</span>
println <span class="hljs-string">&quot;hostname is ${hostname}&quot;</span>

appender(<span class="hljs-string">&quot;STDOUT&quot;</span>, ConsoleAppender) {
    <span class="hljs-comment">// &#x5C06;&#x4F1A;&#x8F93;&#x51FA; &quot;hostname is null&quot;</span>
    println <span class="hljs-string">&quot;hostname is ${hostname}&quot;</span>
}
</code></pre>
<p>&#x5982;&#x679C;&#x4F60;&#x60F3;&#x8981;&#x5728;&#x6240;&#x6709;&#x7684;&#x4F5C;&#x7528;&#x57DF;&#x4E2D;&#x4F7F;&#x7528; hostname &#x53D8;&#x91CF;&#x3002;&#x90A3;&#x4E48;&#x4F60;&#x9700;&#x8981;&#x5B9A;&#x4E49;&#x4E00;&#x4E2A;&#x53D8;&#x91CF;&#xFF0C;&#x5E76;&#x5C06; &apos;hostname&apos; &#x7684;&#x503C;&#x8D4B;&#x7ED9;&#x5B83;&#x3002;&#x5982;&#x4E0B;&#xFF1A;</p>
<pre><code class="lang-groovy"><span class="hljs-comment">// &#x5C06; hostname &#x7684;&#x503C;&#x8D4B;&#x7ED9; HOSTNAME</span>
<span class="hljs-keyword">def</span> HOSTNAME = hostname

<span class="hljs-comment">// &#x5982;&#x679C;&#x5F53;&#x524D; host &#x7684;&#x540D;&#x5B57;&#x4E3A; x&#xFF0C;&#x90A3;&#x4E48;&#x5C06;&#x4F1A;&#x8F93;&#x51FA; &quot;hostname is x&quot;</span>
println <span class="hljs-string">&quot;hostname is ${HOSTNAME}&quot;</span>

appender(<span class="hljs-string">&quot;STDOUT&quot;</span>, ConsoleAppender) {
    <span class="hljs-comment">// &#x5982;&#x679C;&#x5F53;&#x524D; host &#x7684;&#x540D;&#x5B57;&#x4E3A; x&#xFF0C;&#x90A3;&#x4E48;&#x5C06;&#x4F1A;&#x8F93;&#x51FA; &quot;hostname is x&quot;</span>
    println <span class="hljs-string">&quot;hostname is ${HOSTNAME}&quot;</span>
}
</code></pre>
<h3 id="&#x4EFB;&#x4F55;&#x5BF9;&#x4E8E;&#x5F53;&#x524D;&#x4E0A;&#x4E0B;&#x6587;&#x7684;&#x5F15;&#x7528;&#x90FD;&#x662F;&#x4E0A;&#x4E0B;&#x6587;&#x611F;&#x77E5;&#x7684;">&#x4EFB;&#x4F55;&#x5BF9;&#x4E8E;&#x5F53;&#x524D;&#x4E0A;&#x4E0B;&#x6587;&#x7684;&#x5F15;&#x7528;&#x90FD;&#x662F;&#x4E0A;&#x4E0B;&#x6587;&#x611F;&#x77E5;&#x7684;</h3>
<p><em>logback.groovy</em> &#x811A;&#x672C;&#x662F;&#x5728; <a href="https://logback.qos.ch/xref/ch/qos/logback/core/spi/ContextAware.html" target="_blank">ContextAware</a> &#x5BF9;&#x8C61;&#x7684;&#x8303;&#x56F4;&#x5185;&#x6267;&#x884C;&#x5B8C;&#x6210;&#x7684;&#x3002;&#x56E0;&#x6B64;&#xFF0C;&#x5728;&#x5F53;&#x524D;&#x4E0A;&#x4E0B;&#x6587;&#x7684;&#x8303;&#x56F4;&#x5185;&#xFF0C;&#x4F60;&#x53EF;&#x4EE5;&#x4F7F;&#x7528; &apos;<code>context</code>&apos;&#xFF0C;&#x5E76;&#x4E14;&#x53EF;&#x4EE5;&#x901A;&#x8FC7; <code>addInfo()</code>&#x3001;<code>addWarn()</code>&#x3001;&#x4E0E; <code>addError()</code> &#x65B9;&#x6CD5;&#x5C06;&#x72B6;&#x6001;&#x4FE1;&#x606F;&#x53D1;&#x9001;&#x7ED9;&#x4E0A;&#x4E0B;&#x6587;&#x7684; <code>StatusManager</code>&#x3002;</p>
<pre><code class="lang-groovy"><span class="hljs-comment">// &#x6DFB;&#x52A0;&#x4E00;&#x4E2A;&#x63A7;&#x5236;&#x53F0;&#x8F6C;&#x6001;&#x76D1;&#x542C;&#x5668;&#x603B;&#x662F;&#x6CA1;&#x9519;&#x7684;</span>
statusListener(OnConsoleStatusListener)

<span class="hljs-comment">// &#x8BBE;&#x7F6E;&#x4E0A;&#x4E0B;&#x6587;&#x7684;&#x540D;&#x5B57;&#x4E3A; wombat</span>
context.name = <span class="hljs-string">&apos;wombat&apos;</span>

<span class="hljs-comment">// &#x6DFB;&#x52A0;&#x4E00;&#x4E2A;&#x5173;&#x4E8E;&#x4E0A;&#x4E0B;&#x6587;&#x540D;&#x5B57;&#x7684;&#x72B6;&#x6001;&#x4FE1;&#x606F;</span>
addInfo(<span class="hljs-string">&quot;Context name has been set to ${context_name}&quot;</span>)

<span class="hljs-keyword">def</span> USER_HOME = System.getProperty(<span class="hljs-string">&quot;user.home&quot;</span>)

<span class="hljs-comment">// &#x6DFB;&#x52A0;&#x5173;&#x4E8E; USRE_HOME &#x7684;&#x72B6;&#x6001;&#x4FE1;&#x606F;</span>
addInfo(<span class="hljs-string">&quot;USER_HOME=${USER_HOME}&quot;</span>)

appender(<span class="hljs-string">&quot;FILE&quot;</span>, FileAppender) {
    addInfo(<span class="hljs-string">&quot;Setting [file] property to [${USER_NAME}/myApp.log]&quot;</span>)
    file = <span class="hljs-string">&quot;${USER_HOME}/myApp.log&quot;</span>
    encoder(PatternLayoutEncoder) {
        pattern = <span class="hljs-string">&quot;%msg%n&quot;</span>
    }
}
root(DEBUG, [<span class="hljs-string">&quot;FILE&quot;</span>])
</code></pre>
<h3 id="&#x6761;&#x4EF6;&#x914D;&#x7F6E;">&#x6761;&#x4EF6;&#x914D;&#x7F6E;</h3>
<p>&#x7531;&#x4E8E; Groovy &#x662F;&#x4E00;&#x79CD;&#x5B8C;&#x5168;&#x6210;&#x719F;&#x7684;&#x7F16;&#x7A0B;&#x8BED;&#x8A00;&#xFF0C;&#x6761;&#x4EF6;&#x8BED;&#x53E5;&#x5141;&#x8BB8;&#x5355;&#x4E00;&#x7684; <em>logback.groovy</em> &#x6587;&#x4EF6;&#x7528;&#x6765;&#x9002;&#x7528;&#x4E0D;&#x540C;&#x7684;&#x73AF;&#x5883;&#xFF0C;&#x4F8B;&#x5982;&#x5F00;&#x53D1;&#xFF0C;&#x6D4B;&#x8BD5;&#x4EE5;&#x53CA;&#x751F;&#x4EA7;&#x3002;</p>
<p>&#x5728;&#x4E0B;&#x4E2A;&#x811A;&#x672C;&#x4E2D;&#xFF0C;console appender &#x6839;&#x636E; host &#x6765;&#x6FC0;&#x6D3B;&#xFF0C;&#x800C;&#x4E0D;&#x662F;&#x6211;&#x4EEC;&#x7684;&#x751F;&#x4EA7;&#x73AF;&#x5883; pixie &#x6216; orion&#x3002;rolling file appender &#x7684;&#x8F93;&#x51FA;&#x76EE;&#x5F55;&#x4E5F;&#x662F;&#x6839;&#x636E; host &#x6765;&#x786E;&#x5B9A;&#x3002;</p>
<pre><code class="lang-groovy">statusListener(OnConsoleStatusListener)

<span class="hljs-keyword">def</span> appenderList = [<span class="hljs-string">&quot;ROLLING&quot;</span>]
<span class="hljs-keyword">def</span> WEBAPP_DIR = <span class="hljs-string">&quot;.&quot;</span>
<span class="hljs-keyword">def</span> consoleAppender = <span class="hljs-literal">true</span>;

<span class="hljs-comment">// hostname &#x662F;&#x5426;&#x5339;&#x914D; pixie &#x6216; orion</span>
<span class="hljs-keyword">if</span> (hostname =~ <span class="hljs-regexp">/pixie|orion/</span>) {
    WEBAPP_DIR = <span class="hljs-string">&quot;/opt/myapp&quot;</span>
    consoleAppender = <span class="hljs-literal">false</span>
} <span class="hljs-keyword">else</span> {
    appenderList.add(<span class="hljs-string">&quot;CONSOLE&quot;</span>)
}

<span class="hljs-keyword">if</span> (consoleAppender) {
    appender(<span class="hljs-string">&quot;CONSOLE&quot;</span>, ConsoleAppender) {
        encoder(PatternLayoutEncoder) {
            pattern = <span class="hljs-string">&quot;%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n&quot;</span>
        }
    }
}

appender(<span class="hljs-string">&quot;ROLLING&quot;</span>, RollingFileAppender) {
    encoder(PatternLayoutEncoder) {
        Pattern = <span class="hljs-string">&quot;%d %level %thread %mdc %logger - %m%n&quot;</span>
    }
    rollingPolicy(TimeBasedRollingPolicy) {
        FileNamePattern = <span class="hljs-string">&quot;${WEBAPP_DIR}/log/translator-%d{yyyy-MM}.zip&quot;</span>
    }
}

root(INFO, appenderList)
</code></pre>



                                
                                </section>
                            
    </div>
    <div class="search-results">
        <div class="has-results">
            
            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
            <ul class="search-results-list"></ul>
            
        </div>
        <div class="no-results">
            
            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
            
        </div>
    </div>
</div>

                        </div>
                    </div>
                
            </div>

            
                
                <a href="11第十一章Joran.html" class="navigation navigation-prev " aria-label="Previous page: 第十一章：Joran">
                    <i class="fa fa-angle-left"></i>
                </a>
                
                
                <a href="13第十三章从log4j迁移.html" class="navigation navigation-next " aria-label="Next page: 第十三章：从 log4j 迁移">
                    <i class="fa fa-angle-right"></i>
                </a>
                
            
        
    </div>

    <script>
        var gitbook = gitbook || [];
        gitbook.push(function() {
            gitbook.page.hasChanged({"page":{"title":"第十二章：Groovy 配置","level":"1.13","depth":1,"next":{"title":"第十三章：从 log4j 迁移","level":"1.14","depth":1,"path":"13第十三章从log4j迁移.md","ref":"13第十三章从log4j迁移.md","articles":[]},"previous":{"title":"第十一章：Joran","level":"1.12","depth":1,"path":"11第十一章Joran.md","ref":"11第十一章Joran.md","articles":[]},"dir":"ltr"},"config":{"plugins":["add-js-css","myseo"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"add-js-css":{"js":["./lib/site.js"]},"myseo":{"description":"logback中文网包含了logback中文文档，最新资讯，应用案例等。logback 继承自 log4j，它建立在有十年工业经验的日志系统之上。它比其它所有的日志系统更快并且更小，包含了许多独特并且有用的特性。","keywords":"logback中文文档, logback api文档, logback log4j,springboot logback,logback日志类型","titlePrefix":"logback中文网|"},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","keywords":"","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"logback中文手册","gitbook":"*","description":""},"file":{"path":"12第十二章Groovy配置.md","mtime":"2019-02-23T10:29:14.000Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-02-24T03:19:05.191Z"},"basePath":".","book":{"language":""}});
        });
    </script>
</div>

        
    <script src="gitbook/gitbook.js"></script>
    <script src="gitbook/theme.js"></script>
    
        
        <script src="gitbook/gitbook-plugin-add-js-css/fda70cfc36440304bb976a11f47eb151-site.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-search/search.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
        
    

    </body>
</html>

